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Objectives 
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Describe  the  uses  of  functions 
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Create  stored  functions 
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Overview  of  Stored  Functions 


A  function  is  a  named  PL/ SQL  block 

A  function  can  be  stored  in  the 
database  as  a  schema  object  for  _ 
repeated  execution.  x^^^^T^ 
A  function  is  called  as  part  of  an 
expression.  ^> 
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Syntax  for  Creating  Functions 


CREATE  [OR  REPLACE]  FUNCTION  function_name 
(parameterl  [model]  datatypel, 

parameter2  [mode2]  datatype2, 

...) 

RETURN  datatype 
IS  |  AS 

PL/ SQL  Block; 


%s         /  \  \  JS^K 

The  PL/  SQL  block  must  have  at  least  one 
RETURN  statement. 
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Example 
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CREATE  OR  REPLACE  FUNCTION  get_sal 
(v_id  IN  employees.employee_id%TYPE) 
RETURN  NUMBER 
IS 

v_salary  employees.salary%TYPE  :=0; 
BEGIN 

SELECT  salary 

INTO  v_salary 

FROM  employees 

WHERE    employee_id  =  v_id; 

RETURN  (v_salary); 
END  get_sal; 

/ 
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Executing  Functions 


Invoke  a  function  as  part  of  a  PL/ SQL 
expression.  ^^^^^^^^^^^^^^^ 

Create  a  variable  to  hold  the  returned 

Execute  the  function.  The  variable  will 
be  populated  by  the  value  returned 
through  a  RETURN  statement. 


1^ 
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Executing  Functions:  Example 


Create  the  function  GET  SAL  function 


DECLARE 
v_salary  number; 


v_salary  :=  get_sal(100); 
dbms_output.put_line(  v_salary); 
END  ; 
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Advantages  of  User-Defined  Functions 


Extend  SQL  where  activities  are  too^^^^ 
complex,  too  awkward,  or  unavailable  with  SQL 


Can  increase  efficiency  when  used  in  the 
WHERE  clause  to  filter  data,  as  opposed  to 
filtering  the  data  in  the  application 


Can  manipulate  character  strings 
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Invoking  Functions  in  SQL  Expressions 


CREATE  OR  REPLACE  FUNCTION  tax(p_value  IN 
NUMBER) 

RETURN  NUMBER  IS 
BEGIN 

RETURN  (p_value  *  0.08); 
END  tax; 

/ 


SELECT  empno,  ename,  sal,  tax(sal) 
FROMemp  /  ^/ 
WHERE  deptno=  10; 
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Restrictions  on  Calling  Functions  from  SQL 


To  be  callable  from  SQL  expressions,  a  user-defined 
function  must: 


•  Be  a  stored  function^/  r\^h^  — 

•  Accept  only  IN  parameters  V^-^  ^^W^^^T^/W^ 

•  Accept  only  valid  SQL  data  types,  not  PL/ SQL 
specific  types,  as  parameters  r^^^^Xk 

•  Return  data  types  that  are  valid  SQL  data  types, 
not  PL/SQL  specific  types 


v 
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Restrictions  on  Calling  Functions  from  SQL 


Functions  called  from  SQL  expressions  cannot 
contain  DML  statements. 

Functions  called  from  UPDATE/ DELETE  statements 
on  a  table  T  cannot  contain  DML  on  the  same  table  T. 
Functions  called  from  an  UPDATE  or  a  DELETE  ^\ 

statement  on  a  table  T  cannot  query  the  same  table. 
Functions  called  from  SQL  statements  cannot 

contain  statements  that  end  the  transactions. 
Calls  to  subprograms  that  break  the  previous 

restriction  are  not  allowed  in  the  function. 
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Restrictions  on  Calling  Functions  from  SQL 


CREATE  OR  REPLACE  FUNCTION  dml_call_sql  (p_sal  NUMBER) 

RETURN  NUMBER  IS 
BEGIN 

INSERT  INTO  empfempno,  ename,  hire  date,  job,  sal) 
VALUES(1,  employee  1',  SYSDATE,  SA_MAN',  1000); 
RETURN  (p_sal  +  100); 
END; 

/ 


ERROR  at  line  1: 

ORA-04091:  table  scott.EMP  is  mutating,  trigger/function  may  not  see  it 
ORA-06512:at"scott.DML  CALL  SQL",  line  4 


J7 


UPDATE  emp  SET  sal  =  dml_call_sql(2000) 
WHERE  empno  =  7839; 

Mutating  Table 
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Removing  Functions 


DROP  FUNCTION  function_name 


"DROP  FUNCTION  getajj/  3|cR^T^<^C^^^^^^^ 

•  All  the  privileges  granted  on  a  function  are  revoked  when 
tjigj^ 

•  The  CREATE  OR  REPLACE  syntax  is  equivalent 
to  dropping  a  function  and  recreating  it.  Privileges 
granted  on  the  function  remain  the  same  when  this  syntax 
is  used. 


•  All  the  privileges  granted  on  a  function  are  revoked 
when  the  function  is  dropped.  ^ 
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Procedure  or  Function? 


What  would  be  the  logical  choice  for  1  and  2? 

1.  A  subprogram  that  accepts  one  value  and  outputs 

2.  A  subprogram  that  accepts  one  value  and  outputs 
one  value 
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Comparing  Procedures  and  Functions 


Procedu  res 

Functions 

Execute  as  a  PL/  SQL  statement 

Invoke  as  part  of  an  expression 

Do  not  contain  RETURN  clause 
in  the  header 

Must  contain  a  RETURN  clause 
in  the  header 

Can  return  none,  one,  or  many 
values 

Must  return  a  single  value 

Can  contain  a  RETURN 
Statement 

Must  contain  at  least  one 
RETURN  statement 
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Benefits  of  Stored  Procedures  and  Functions 


Improved  performance 
Easy  maintenance  frs^ 


Improved  data  security  and  integrity 


Improved  code  clarity 
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Summary 
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A  function  is  a  named  PL/  SQL  block  that  must 

returB^^^^^1^^^^!^:^^^^^^^^^^^^ 
A  function  is  created  by  using  the  CREATE 
FUNCTION  syntax mY     ^   ^  yZI^^N^ 
A  function  is  invoked  as  part  of  an  expression. 
A  function  stored  in  the  database  can  be  called  in 

A  function  can  be  removed  from  the  database  by 
using  the  DROP  FUNCTION  syntax.  s~  J) 
Generally,  you  use  a  procedure  to  perform  an 
action  and  a  function  to  compute  a  value. 
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Thank  You  ! 


Copyright  ©  CD  AC- ACTS 


18 


